Inside Macintosh: QuickDraw GX Printing /

Chapter 4 - Advanced Printing Features / Advanced Printing Features Reference

Functions / Working With Paper Types

GXForEachJobPaperTypeDo

You can use the GXForEachJobPaperTypeDo function to call an application-defined function for each paper-type definition that is accessible to a particular job object.

void GXForEachJobPaperTypeDo (gxJob aJob, 
                           gxPaperTypeProc aPaperTypeProc,
                           void *refCon,
                           Boolean forFormattingPrinter);

aJob

A reference to the job object from which to obtain the paper-type object.

aPaperTypeProc

An application-defined function to be called for each paper-type definition accessible to a job object.

refCon

A pointer to a reference constant.

forFormattingPrinter

A Boolean value that specifies whether the paper-type objects are associated with the formatting printer (true) or with the output printer (false).

DESCRIPTION

The GXForEachJobPaperTypeDo function loops over each of the paper-type objects for the specified print job, executing the application-supplied function on each one.

The application-defined function is called until either all the paper types have been processed or the function returns the gxStopLooping constant.

Set the forFormattingPrinter parameter to true to execute the application-defined function only on the paper types associated with the formatting printer or to false to execute the application-defined function only on paper types associated with the output printer.

RESULT CODES

gxSegmentLoadFailedErr

A required code segment could not be found, or there was not enough memory to load it.

SEE ALSO

For an example that uses the GXForEachJobPaperTypeDo function, see "Scanning the Paper Types Available to a Job" on page 4-34.

For information about declaring the application-defined function, see "Looping Through a Job's Paper Types" on page 4-92.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help